package com.education.platform.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.education.platform.dto.message.MessageSendDTO;
import com.education.platform.entity.Message;

import java.util.List;

/**
 * 消息服务接口
 *
 * @author education-platform
 * @since 2024-10-07
 */
public interface MessageService {

    /**
     * 发送消息
     */
    Long sendMessage(Long fromUserId, Long toUserId, String content, String contentType, String extraData);

    /**
     * 发送系统消息
     */
    Long sendSystemMessage(Long toUserId, String title, String content, String extraData);

    /**
     * 批量发送系统消息
     */
    void batchSendSystemMessage(List<Long> userIds, String title, String content, String extraData);

    /**
     * 广播消息
     */
    void broadcastMessage(String title, String content, String extraData);

    /**
     * 标记消息为已读
     */
    void markMessageAsRead(Long messageId, Long userId);

    /**
     * 批量标记消息为已读
     */
    void batchMarkAsRead(List<Long> messageIds, Long userId);

    /**
     * 标记会话消息为已读
     */
    void markConversationAsRead(String conversationId, Long userId);

    /**
     * 删除消息
     */
    void deleteMessage(Long messageId, Long userId);

    /**
     * 根据ID获取消息
     */
    Message getMessageById(Long id);

    /**
     * 分页查询消息列表
     */
    IPage<Message> getMessagePage(Page<Message> page, Long userId, String conversationId, String type, String status);

    /**
     * 查询会话消息列表
     */
    List<Message> getConversationMessages(String conversationId, Integer limit);

    /**
     * 查询用户未读消息
     */
    List<Message> getUnreadMessages(Long userId);

    /**
     * 统计用户未读消息数量
     */
    Integer countUnreadMessages(Long userId);

    /**
     * 统计会话未读消息数量
     */
    Integer countUnreadByConversation(String conversationId, Long userId);

    /**
     * 查询系统消息
     */
    List<Message> getSystemMessages(Long userId, Integer limit);

    /**
     * 查询最近聊天用户
     */
    List<Message> getRecentChatUsers(Long userId, Integer limit);

    /**
     * 处理用户上线
     */
    void handleUserOnline(Long userId);

    /**
     * 处理用户下线
     */
    void handleUserOffline(Long userId);

    /**
     * 清理过期消息
     */
    void cleanExpiredMessages(Integer days);
}
